home *** CD-ROM | disk | FTP | other *** search
/ Compendium Deluxe 2 / LSD and 17bit Compendium Deluxe - Volume II.iso / a / prog / misc / interfaces3_5.lha / ReadMe < prev    next >
Encoding:
Text File  |  1994-11-07  |  10.6 KB  |  336 lines
  1.                                                           06 Nov 1994
  2.  
  3.           AmigaOberon System Interfaces 40.15 Oberon 3.5
  4.           ==============================================
  5.  
  6.    © Copyright 1992-1994 by Fridtjof Siebert und hartmut Goebel
  7.  
  8.  
  9. This archive holds the AmigaOberon Interfaces for AmigaOS 3.1 (V40),
  10. based on includes V40.15, Oberon Version 3.5.
  11.  
  12. NOTE: The numbering scheme has been changed to reflect the original
  13.       include version and the Oberon version has been added. So
  14.       Interfaces 40.15 Oberon 3.x are successors of the previously
  15.       released Interfaces 40.17.
  16.  
  17.  
  18. Copyright
  19. =========
  20.  
  21.   This interfaces are
  22.  
  23.      © Copyright 1992-1994 by Fridtjof Siebert und hartmut Goebel
  24.  
  25.   The complete and unchanged archive may be freely distributed for
  26.   use with AmigaOberon only. Please consult the AmigaOberon manual
  27.   for detailed licence.
  28.  
  29. Warranty
  30. ========
  31.  
  32. I've done my best to remove all recently knows bugs (but please check
  33. with the bugs file, if supplied) and convert the includes as good as
  34. possible. But remember:
  35.  
  36.    * No Warranty
  37.  
  38.      THE MODULES AND PROGRAMS ARE PROVIDED "AS IS" WITHOUT WARRANTY
  39.      OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  40.      LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
  41.      FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE
  42.      RESULTS AND PERFORMANCE OF ANY MODULE IS ASSUMED BY YOU.
  43.  
  44. When you find any bugs, please mail them to:
  45.  
  46.   interface-bugs@oberon.nbg.sub.org
  47.  
  48. Your report will then be added to the bugs database automatically and
  49. you'll get a reciept notification. PLEASE use this service to make
  50. sure every report reaches me! I may miss reports posted to news
  51. groups (I read only very few of them).
  52.  
  53.  
  54. Installation
  55. ============
  56.  
  57. ATTENTION: Please use 'recomp3_10.lst' for AmigaOberon V3.10/3.11
  58.            (and probably higher) since there have been some changes
  59.            in the module compilation order.
  60.  
  61.            I heard some guys had had problems since the module
  62.            Objects.mod couldn't be found, even it is on my original
  63.            v3.11 disks. If you don't have this module, just delete
  64.            the one line in recomp3_10.lst.
  65.  
  66. NOTE: Due to changes in the Interfaces you may have to do some
  67.       changes in standard modules which come with AO 3.0+. See 'List
  68.       of Changes to do' below.
  69.  
  70. For re-compiling all modules proceed as follows or use the brand new
  71. Installer script
  72.  
  73.   ;
  74.   ; activate you Oberon environment
  75.   ;
  76.   assign om: Oberon:Module      ;or wherever they are
  77.   assign oa: Oberon:Interfaces  ;    - " -
  78.   cd Oberon:                    ;or wherever you module's sym/ and obj/ dirs are
  79.   lha x Interface38,108 *.mod oa:/
  80.   residentmanager reset
  81.   delete sym/#? all quiet force ; old sym are obsolete
  82.   Oberon <recomp.lst        ; or recomp3_10.lst'
  83.   Oberon -a <recomp.lst     ; or recomp3_10.lst'
  84.   Oberon -md <recomp.lst    ; or recomp3_10.lst'
  85.   Oberon -mad <recomp.lst   ; or recomp3_10.lst'
  86.  
  87. The script is not able to recompile the LibOberonLib modules. If you
  88. need them, please proceed as follows:
  89.  
  90.   cd Oberon:LibLink
  91.   oberon -md SET LibLink om:OberonLib
  92.   oberon -mad SET LibLink om:OberonLib
  93.   rename obj/OberonLib.objs obj/LibOberonLib.objs
  94.   rename obj/OberonLib.objsa obj/LibOberonLib.objsa
  95.  
  96.  
  97. List of Changes to do in the Modules
  98. ====================================
  99.  
  100. This is a list of changes to be done in the original AmigaOberon
  101. modules to work together with the current version of Interfaces.
  102. Please check whether this changes still have to de done to the
  103. version of modules you have. No guaranty can be give for the
  104. completness and/or correctness of this list.
  105.  
  106. Note for AO 3.10:
  107.   The files NoGuruRq.mod and BreakRq.mod are obsolete, so don't
  108.   hesitate to delete them. They are now generated out of NoGuru.mod
  109.   respectivly Break.mod by setting a compiler switch.
  110.  
  111. *changes for 40.15/3.4*
  112.  
  113.   · Alerts.mod
  114.     replace every occurenc of RawDoFmt() through OldRawDoFmt()
  115.  
  116.   · FileReq.mod
  117.     remove the '#NIL' behind asl.AslRequestTags(...)
  118.  
  119.   · io.mod
  120.     - exchange the one occurance of STRPTR through LSTRPTR.
  121.     - replace every occurenc of RawDoFmt() through OldRawDoFmt()
  122.  
  123.   · Display.mod
  124.     You MUST NOT change the type STRPTR, since this would lead to big
  125.     trouble (see note below, too). Instead change the tree
  126.     assignments like
  127.         nw.title := win.title;
  128.     into
  129.         nw.title := sys.ADR(win.title^);
  130.  
  131.  
  132. Release Notes
  133. =============
  134.  
  135. *** 40.15/3.5 ***
  136.  
  137.   Intuition
  138.   · export screenHires again (seems to be usefull :-)
  139.   · IClass.reserved and Object.node are no longer exported
  140.   · fixed flag values for AllocScreenBuffer()
  141.   · changed flags for ScreenDeepth() into sets, thereby correcting
  142.     the values
  143.   · renamed sysIsSize... to sysisize... (sorry, typo)
  144.   · PointInImage() should expect Graphics.Point as first Parameter,
  145.     but changing the paramter's type would have lead to the address
  146.     been moved into the register instead of the value itself (Point
  147.     is a stuctured type). Thus the direct LVO call has been renamed
  148.     to PointInImageL() and the new stub routine PointInImage() takes
  149.     Graphics.Point as first parameter and hides the type-cast.
  150.  
  151.   Classface
  152.   · CoerceMethod(A) didn't return a result
  153.   · Added some aliasas for ignoring results (the 'M' of method is
  154.     lowercase)
  155.   · ObjectPtr (as argument for all procedures) is now Exec.APTR,
  156.     since most times you have to cast or use odd things like
  157.     SYSTEM.ADR(foo^).
  158.  
  159.   Locale
  160.   · Added some missing definitions like LocaleBase and calendar
  161.     types. This slipped through since I hadn't had the includes the
  162.     very first version was derived from.
  163.   · Removed a definition which sould not be there :-)
  164.  
  165.   Graphics
  166.   · ObtainPen()'s last parameter is now correctly flags: LONGSET
  167.   · TextExtent() is now defined correctly
  168.  
  169.   RealTime
  170.   · Conductor.flags is not correctly defined as SET
  171.  
  172.   Utility
  173.   · New procedures Bool2Long() and Long2Bool() for easy converting
  174.     boolean tags
  175.   · Second parameter of TagInArray() and FilterTagItems() is now
  176.     ARRAY OF TagID, TagInArrayA() has been removed. After reading the
  177.     autodocs another time it showed up that this are no arrays of
  178.     TagItems but arrays of TagIDs.
  179.  
  180. *** 40.15/3.4 ***
  181.  
  182.   · Graphics.Layer fields are now read-only ([Libs3] p.704)
  183.   · Narrator.Mouth.shape is now read-only
  184.   · new type Utility.AsmHookFunc for easier casting
  185.   · Exec.SINGLE changed from LONGREAL to LONGSET to avoid intermix,
  186.     constants in MathIEEESingBas.mod are now casted to Exec.SINGLE
  187.  
  188. *** 40.15/3.3 ***
  189.  
  190.   · optimized Graphics.SaveSetWriteMask() (register parameters)
  191.   · Utility.HookEntry() returns Exec.APTR;
  192.   · Intuition.BuildEasyRequestArgs() passed arg1 in wrong register
  193.   · Dos.SetMode() returns BOOLEAN (according to autodocs)
  194.  
  195. *** 40.15/3.2 *** (was 40.17)
  196.  
  197.   · Bad, bad: Exec.mod had had no module body if compiled for
  198.     AmigaOberon 3.10+. Fixed.
  199.   · Dos.CSource.buffer is now Exec.LSTRPTR, too.
  200.  
  201. *** 40.15/3.1 *** (was 40.16)
  202.  
  203.   · Commodities: PFT renamed to PFL
  204.   · Dos.Fault() now returns LONGINT
  205.   · IFFParse: errMamgled renamed to errMangled
  206.   · Printer: Bugs in PrinterData and DeviceData removed
  207.   · Workbench.WBArguments is now
  208.       ARRAY MAX(LONGINT) DIV Size(WBArg) -1 OF WBArg;
  209.  
  210. *** 40.15/3.0 *** (was 40.15)
  211.  
  212.   · all (* char) are now Exec.LSTRPTR !!!
  213.     BEWARE: do not allocate a pointer of this type, since this will
  214.             try allocate 2GB of memory
  215.             do not dereference exept for VAR parameters and for
  216.             procedures where $CopyArray- is set.
  217.     See note above for changes in standard modules.
  218.   · to improve date/type savety a lot of record/struct
  219.     fields are marked as read-only or are not longer exported. E.g.
  220.     in modules ASL, ConUnit, Config, Datatypes, DiskFont, Dos, Exec,
  221.     Graphics, RealTime, ...
  222.   · checked all imports wether they are marked if used in interface
  223.     (e.G. SYSTEM)
  224.   · includes Albert Weinerts 'Classface' package (originally named
  225.     'Boopsi')
  226.   · includes Martin Honeffers 'RVI' package (for rexxvars)
  227.   · all modules terminate with HALT(20) now if OpenLib() fails
  228.   · a lot of small procedures now got register parameters for better
  229.     code
  230.  
  231.   Dos
  232.   · new type DeviceListAPtr, DevInfoAPtr, DosListAPtr
  233.  
  234.   Exec
  235.   · bug with StackSwap() removed
  236.   · new tpye LSTRPTR
  237.  
  238.   Commodities.mod
  239.   · bug removed with constants duplicate, notify, unique
  240.   · removed CxFilter (obsolete)
  241.  
  242.   GadTools
  243.   · new constant value: 'noList' for short list locking (see RKMs)
  244.  
  245.   Gadgets
  246.   · new Proc: CloseColorWheel()
  247.  
  248.   Graphics
  249.   · new PROCEDURE GetOPen synonym for consistency with
  250.     SettOutlinePen/SetOPen
  251.  
  252.   InputEvent
  253.   · InputEvent is now only a dummy base type
  254.  
  255.   Intuition
  256.   · OpGet.storage is now pointer to Exec.ADDRESS
  257.   · bug removed: SetScreenposition()-Flags
  258.  
  259.   Utility
  260.   · new type HookFunc
  261.   · new PROCEDURE GetTagDataP(A) --- nachsehen
  262.   · introduced TagListPtr (more security and comfort)
  263.   · removed bug in SMult32 UMult32
  264.  
  265.   Workbench
  266.   ·  Type WBArguments is now ARRAY MAX(INTEGER) OF WBArg (was ARRAY 256)
  267.  
  268. *** 40.5 ***
  269.  
  270.   Added interfaces
  271.   · CDDevice.mod (original name is devices/cd.h but CD.mod would be to short)
  272.   · LowLevel.mod
  273.   · NonVolatile.mod
  274.   · RealTime.mod
  275.  
  276.   Renamed DataTypes.mod to Datatypes.mod (was tippo)
  277.  
  278.   Removed interface DTClass.mod:
  279.     this is was originaly a prototype for DTClass and is not usable
  280.     in Oberon this way.
  281.  
  282.  
  283. *** 39.108 ***
  284.  
  285.   · all names of libs, devices etc. are now exported constants
  286.   · removed some tippos
  287.   · optical clean up
  288.  
  289.   Dos
  290.   · intoduced type 'ArgsStruct' and some additional types to improve
  291.     type savety for ReadArg().
  292.   · ReadArgs() now want's this type as parameter, OldReadArgs() still
  293.     has old parameters.
  294.  
  295.   Exec
  296.   · new type LONGBOOL and consts LTRUE, LFALSE since used in
  297.     different interfaces
  298.   · RawDoFmt() now returns e.APTR, OldRawDoFmt returns nothing
  299.  
  300.   Intuition
  301.   · some u.TagItemPtrs are now u.TagListPtrs for easier handling
  302.     (e.g. in boopsi messages).
  303.   · MakeScreen, RemakeDisplay and RethinkDisplay now return LONGINT;
  304.     Oldxxx still return nothing
  305.   · OldActivatedWinodw() removed (unnecesary).
  306.  
  307.   Locale
  308.   · constant identifiers now start with lower case charakters
  309.   · clean up
  310.  
  311.   Utility
  312.   · new type 'TagListPtr' to improve handling of Taglists
  313.   · some functions return TagListPtr instead of e.ADDRESS;
  314.  
  315.   Added interfaces
  316.     AmigaGuide.mod (supplied by Lars Düning)
  317.     Bullet.mod
  318.     CardRes.mod
  319.     DTClass.mod
  320.     DataTypes.mod
  321.     Gadgets.mod
  322.     Prefs.mod
  323.     Sana2.mod (supplied by Nicolas Benezan [bene])
  324.  
  325. Literature:
  326.  
  327. [Libs3] RKM Libraries, 3rd Edition
  328. [Devs3] RKM Devices, 3rd Edition
  329.  
  330. Enjoy it!
  331. +++hartmut
  332.  
  333. | Hartmut Goebel | UseNet: hartmut@oberon.nbg.sub.org     // Only Amiga |
  334. | Amiga Software | Fido:2:246/81.1  IRC: Essich        \\X/ Oberon  ZOC |
  335. | Manufactur     |            PGP key available                         |
  336.